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Voorwaarden 





De iDEAL Merchant Integratie Gids — Overzicht van Wijzigingen wordt door de producteigenaar 
Currence beschikbaar gesteld onder de volgende voorwaarden: 


1 Currence iDEAL B.V. als eigenaar van het iDEAL Scheme stelt de iDEAL Merchant Integratie 


Gids — Overzicht van Wijzigingen beschikbaar aan Acquiring banken die deze vervolgens 
distribueren aan (potentiële) Merchants en Payment Service Providers opdat zij als (potentiële) 
afnemers van iDEAL zich een goed beeld kunnen vormen van de wijzigingen tussen iDEAL 2.2 
en iDEAL 3.3.1 en wat deze betekenen voor hun implementatie van het IDEAL-product. 


Currence iDEAL B.V. behoudt zich het recht voor om beschikbaarstelling van de iDEAL Merchant 
Integratie Gids — Overzicht van Wijzigingen te weigeren voor (potentiële) Merchants en Payment 
Service Providers op grond van haar moverende redenen, in overleg met de Acquiring bank 
waarmee de Merchant/PSP een contract heeft. 


De iDEAL Merchant Integratie Gids — Overzicht van Wijzigingen wordt nadrukkelijk uitsluitend met 
bovenstaand doel ter beschikking gesteld en enig ander gebruik is niet toegestaan. Aan het 
document of de in de bijgaande toelichting gegeven informatie kunnen geen rechten worden 
ontleend. Currence iDEAL B.V. is op geen enkele wijze aansprakelijk voor de gevolgen van latere 
wijzigingen van de iDEAL Standaard of de iDEAL Merchant Integratie Gids — Overzicht van 
Wijzigingen. Indien banken of andere geïnteresseerden beslissingen nemen en/of investeringen 
doen op basis van de informatie die zij via deze iDEAL Merchant Integratie Gids- Overzicht van 
Wijzigingen hebben verkregen, dan accepteert Currence iDEAL B.V. hiervoor geen enkele 
aansprakelijkheid. 


De iDEAL Merchant Integratie Gids — Overzicht van Wijzigingen is een vertaling van de 
Engelstalige iDEAL Merchant Integration Guide — Summary of Changes, die is gebaseerd op de 
informatie in de iDEAL Standaard documenten. Deze vertaling is met grote zorgvuldigheid 
samengesteld. Indien er toch afwijkingen zijn tussen de Nederlandse vertaling en het 
Engelstalige origineel dan is de Engelstalige versie leidend. In het geval er afwijkingen zijn tussen 
de Merchant Integratie Gids — Overzicht van Wijzigingen en de iDEAL Standaard documenten 
dan is de tekst in de Standaard documenten leidend. 


Alle vragen over dit document of verzoeken om meer informatie kunnen worden gericht aan uw iDEAL 
bank of Collecterende Payment Service Provider. 
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1 Inleiding 
1.1 Doelgroep 
iDEAL Merchants zijn bedrijven (webwinkels) die iDEAL betalingen willen ontvangen en daartoe 
een contract hebben afgesloten met een bank. 
Dit document is bedoeld voor iDEAL Merchants die willen aansluiten op het iDEAL platform van 
de door hen gekozen Acquiring bank. Het behandelt het berichtenverkeer tussen Merchants en 
hun bank. Voor Merchants is het berichtenverkeer tussen consumentenbanken (Issuers) en 
merchant-banken (Acquirers) niet van belang. Dit deel van de iDEAL standaard wordt daarom in 
dit document niet behandeld. 
Dit document is niet bank specifiek, dat wil zeggen dat alleen generieke iDEAL zaken in dit 
document worden behandeld. Informatie over non-standaard aansluitvormen bij specifieke 
banken en de hulp(middelen) die een bank verstrekt om aan te sluiten op iDEAL zijn geen 
onderdeel van de Integratie Gids. Voor informatie over deze onderwerpen verwijzen wij u naar de 
door uw bank verstrekte (aanvullende) documentatie. 
1.2 Document opzet 
Hoofdstuk 2 geeft een algemeen overzicht van de wijzigingen in de iDEAL standaard van iDEAL 
2.2 naar iDEAL 3.3.1. Hoofdstuk 3 geeft een overzicht van de specifieke wijzigingen per bericht of 
stap in het protocol. 
1.3 Herzieningen 
Versie Omschrijving van versie Datum gereed 
3.3.0 Eerste Nederlandse vertaling van de Engelse ‘Merchant 20-02-2012 
concept Integration Guide — Summary of Changes Version 3.3.0’ 
3.3.0 Commentaar CAB verwerkt. Versie voor publicatie 07-03-2012 
definitief 
3.3.1 Versie aangepast aan veranderingen in iDEAL Standaard 3.3.1 12-04-2012 
definitief 
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2 


Algemene wijzigingen in iDEAL 





2.1 


2.2 


2.3 


Inleiding 


Dit document geeft een overzicht van de belangrijkste wijzigingen in de iDEAL standard 
documenten van versie 2.2 naar 3.3.1. Dit zijn: 
e Digitale handtekeningen: In 3.3.1 wordt XMLSIG, de internationale standaard voor 
digitale handtekeningen, gebruikt. Alle berichten en antwoorden worden digitaal 


ondertekend. De algoritmes voor digitale handtekeningen zijn bijgewerkt van SHA-1 naar 
SHA256 en van RSA1024 naar RSA2048. 


e IBAN: Alle referenties naar Nederlandse bankrekeningen zijn gewijzigd naar internationale 
bankrekeningnummers (IBANs). 


e Uitvoering van de betaling: transacties met iDEAL 3.3.1 zullen resulteren in een 
Nederlandse overboeking (tot deze volledig is uitgefaseerd), of een SEPA Credit Transfer. 


e Bedrag in Euro: het bedrag van de betaling wordt niet langer vermeld in eurocenten maar 
in hele euro's, met twee decimalen. 


e BIC als IssuerlD: Issuing Banken worden in iDEAL 3.3.1 geïdentificeerd met hun Bank 
Identifier Code (BIC). 


e Unicode karakter set: in plaats van de beperkte karakterset die voor interbancaire 
uitwisseling wordt gebruikt, zal de Unicode karakter set worden gebruikt voor alle IDEAL 
3.3.1 berichten. 


e Referenties: Alle referenties naar versienummers zijn bijgewerkt van 1.1.0 naar 3.3.1 


Deze wijzigingen en een aantal meer specifieke wijzigingen in berichten, worden hieronder in 
meer detail beschreven. In alle gevallen wordt gerefereerd aan de iDEAL Standaard documenten 
waar meer gedetailleerde informatie beschikbaar is. 


Digitale handtekeningen 


Alle berichten die door de Merchant naar de Acquirer worden gestuurd (DirectoryRequest, 
TransactionRequest en StatusRequest) moeten digitaal ondertekend worden door de Merchant. 
Alle berichten die door de Acquirer naar de Merchant worden gestuurd (DirectoryResponse, 
TransactionResponse en StatusResponse) moeten digitaal worden ondertekend door de 
Acquirer. Berichten worden getekend volgens de richtlijn "XML Signature Syntax and Processing 
(2"° Edition) W3C Recommendation” van 10 juni 2008. 


Voor het ‘hashen’ wordt het SHA256 algoritme gebruikt. RSA sleutels voor het digitaal tekenen 
moeten 2.048 bits lang zijn. 


De velden Authentication, token, tokenCode en fingerprint worden niet meer 
gebruikt. In plaats daarvan worden de velden signedInfo (met sub-velden) en KeyInfo 
gebruikt. Het gebruik van signatureValue is veranderd en voldoet nu aan de definitie in de 
XML Signature standaard. 


Referentie: Zie voor details de Merchant Integratie Gids v3.3.1 — paragraaf 8.2 Digitaal tekenen 
van iDEAL berichten, Appendix A: Data catalogus en Appendix D: XML berichten schema. 


IBAN 


In plaats van het Nederlandse bankrekeningnummer maakt iDEAL 3.3.1 gebruik van IBANs (met 
de daarbijbehorende BICs) voor zowel de rekening van de Consument als die van de Merchant. 
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2.4 


2.5 


2.6 


2.7 


2.8 


Referentie: Zie voor details Merchant Integratie Gids v3.3.1 — paragraaf 3.3 Merchant informatie 
geregistreerd bij de Acquirer en paragraaf 6.3 StatusResponse. Zie ook Appendix A: Data 
catalogus en Appendix D: XML berichten schema. 


Uitvoering van de betaling 


- Geslaagde iDEAL 3.3.1 transacties zullen resulteren in óf een Nederlandse overboeking naar 
de rekening van de Merchant, óf een SEPA Credit Transfer (SCT) naar de rekening van de 
Merchant. In de Merchant Integratie Gids is een gedetailleerde beschrijving opgenomen hoe 
de velden uit de iDEAL berichten worden vertaald naar de velden van de Nederlandse 
overboeking of de SCT. 


- Op enig moment zal de Nederlandse overboeking uitgefaseerd worden en zullen Merchants 
alleen nog maar SCTs ontvangen na een geslaagde iDEAL transactie. 


Referentie: Meer details zijn te vinden in de Merchant Integratie Gids v3.3.1 — paragraaf 5.7 
Uitvoering van betalingen. 


Bedrag in euro 


De berichten TransactionRequest en StatusResponse bevatten het bedrag van de transactie in 
het veld amount. Voortaan is dit een bedrag in euro, met een punt als scheidingsteken voor de 
decimalen (in iDEAL 2.2 was het bedrag nog gespecificeerd in eurocenten). 


Referentie: Zie voor details Merchant Integratie Gids v3.3.1 — paragraaf 5.2 TransactionRequest, 
paragraaf 6.3 StatusResponse en Appendix A Data catalogus. 


BIC als IssuerlD 


In plaats van het voorheen gebruikte viercijferige identiteitsnummer voor iDEAL Issuers, gebruikt 
iDEAL 3.3.1 de internationale ‘Bank Identifier Code’ (BIC) voor de identificatie van Issuing 
banken. 


Referentie: Zie voor details Merchant Integratie Gids v3.3.1 — paragraaf 4.3 DirectoryResponse, 
paragraaf 4.4 Presentatie van de Issuerselectielijst, paragraaf 5.2 TransactionRequest en 
Appendix A Data catalogus. 


Unicode karakterset 


Alle berichten in iDEAL 3.3.1 maken gebruik van de Unicode karakterset. Om specifieker te zijn 
wordt de MES-2 deelverzameling hiervan gebruikt. De encoding die gebruikt moet worden is 
UTF-8 (Unicode Transformation Format), zoals gespecificeerd in de HTTP en XML headers. 
Diakritische tekens (à, ç, ô, ü, ý etc.) en karakters die niet in Unicode voorkomen kunnen 
gewijzigd worden door verzender, ontvanger of tussenliggende partijen. 


Reference: Zie voor details Merchant Integratie Gids v3.3.1 — Appendix A Data catalogus. 


Referenties 


In alle berichten die het veld Version bevatten, wordt het versienummer 3.3.1. De XML 
namespace voor nieuwe berichten wordt 
http://www.idealdesk.com/ideal/messages/mer-acq/3.3.1 





Referentie: Voor details zie: Merchant Integratie Gids v3.3.1 - Appendix A: Data catalogus en 
Appendix B: Voorbeeldberichten 
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3 


3.1 


3.2 


3.3 


3.4 


Specifieke wijzigingen van iDEAL berichten en protocollen 


Inleiding 


Dit hoofdstuk beschrijft specifieke wijzigingen in iDEAL berichten en protocollen. Deze specifieke 
wijzigingen zijn aanvullend op de algemene wijzigingen die op alle iDEAL berichten van 
toepassing zijn bij de overgang van versie 2.2 naar versie 3.3.1. De algemene wijzigingen zijn al 
in het vorige hoofdstuk beschreven. 


Merchantinformatie geregistreerd bij de Acquirer 


- legalName van de Merchant heeft 35 karakters vanaf de start van iDEAL 3.3.1 (ongewijzigd 
ten opzichte van iDEAL 2.2), maar wordt op een later moment uitgebreid naar een maximum 
van 70 karakters. U krijgt bericht van uw Acquiring bank als het zover is. 


- tradeName van de Merchant (indien gebruikt) is 32 karakters lang bij de start van iDEAL 
3.3.1 (ongewijzigd ten opzichte van iDEAL 2.2), maar wordt op een later moment uitgebreid 
naar een maximum van 35 karakters. U krijgt bericht van uw Acquiring bank als het zover is. 


Referentie: Voor details: Merchant Integratie Gids v3.3. 1 — paragraaf 3.3 Merchant informatie 
geregistreerd bij de Acquirer. 


Directory response (ÀA’) 
- Hetveld createDateTimeStamp wordt toegevoegd aan het DirectoryResponse bericht. 


- Issuers in de DirectoryResponse staan nu gegroepeerd per land. Het veld count ryNames 
bevat de naam van het land. Merchants moeten banken gegroepeerd per land weergeven, 
maar kunnen ervoor kiezen één bepaald land (bijvoorbeeld Nederland voor Nederlandse 
Merchants) bovenaan de lijst weer te geven. 


- Eris niet langer een TssuerList veld omdat er niet langer wordt gewerkt met een shortlist of 
longlist van banken, alleen nog één lijst die gegroepeerd is per land. 


Referentie: Voor details: Merchant Integratie Gids v3.3.1 — paragraaf 4.3 DirectoryResponse en 
4.4 Presentatie van de Issuerselectielijst. 


TransactionRequest (B) en TransactionResponse (B’) 


- Hetveld purchaseIDis 16 karakters lang bij de start van iDEAL 3.3.1 (ongewijzigd ten 
opzichte van iDEAL 2.2), maar wordt op een later moment uitgebreid naar een maximum van 
35 karakters. U krijgt bericht van uw Acquiring bank als het zover is. 


- Het veld Description is 32 karakters lang bij de start van iDEAL 3.3.1 (ongewijzigd ten 
opzichte van iDEAL 2.2), maar wordt op een later moment uitgebreid naar een maximum van 
35 karakters. U krijgt bericht van uw Acquiring bank als het zover is. 


- Het MerchantReturnURL element hoeft niet meer verplicht te beginnen met ‘http://’ of 
‘https://’ maar moet wel verplicht verwijzen naar (een deel van) de website van de Merchant. 


Referentie: Voor details: Merchant Integratie Gids v3.3.1 — paragraaf 5.2 TransactionRequest, 
paragraaf 5.3 TransactionResponse en Appendix D: XML berichten schema. 
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3.5 


3.6 


3.7 


Verwerkingssnelheid en time-out van betalings- en statusberichten 


- In iDEAL 3.3.1 zijn de streefwaarden voor verwerkingssnelheid en time-out periodes voor 
betalings- en statusberichten zoals die door Merchants in acht zouden moeten worden 
genomen geactualiseerd en in meer detail uitgewerkt. 


Referentie: Voor meer details: Merchant Integratie Gids v3.3.1 — paragraaf 5.6 
Verwerkingssnelheid en time-out van betalingsberichten en paragraaf 6.5 Verwerkingssnelheid 
en time-out van statusberichten. 


StatusResponse (F°) 


- Het veld statusDateTimestamp is toegevoegd aan het StatusResponse bericht. Dit geeft 
de datum en tijd aan waarop de Issuer de status heft vastgesteld voor de betreffende 
transactie en dit heeft opgeslagen als onderdeel van de transactiedetails. 


- consumerName is niet altijd meer een onderdeel van het statusResponse bericht, ook al is 
een transactie geslaagd. Dit kan voorkomen wanneer de consumentenbank zich in een land 
bevindt waar de lokale wetgeving de Issuer verbiedt dergelijke informatie bekend te maken. 
In dergelijke gevallen zal het veld worden gevuld met ‘N/A’ wat staat voor ‘not available’. 


- Het veld consumerName is 70 karakters lang. Bij de start van iDEAL 3.3.1 worden echter 
alleen de eerste 35 karakters gebruikt. Het gebruik van het veld wordt uitgebreid naar de 
volledige 70 karakters op een later moment. U krijgt bericht van uw Acquiring bank als het 
zover is. 


- De velden consumerIBAN en consumerBIC hoeven niet altijd meer onderdeel te zijn van 
het statusResponse bericht, zelfs wanneer de transactie geslaagd is. Dit kan voorkomen 
wanneer de consumentenbank zich in een land bevindt waar de lokale wetgeving de Issuer 
verbiedt dergelijke informatie bekend te maken. 


- Het amount veld van de transactie (in euro, met een decimaalscheidingsteken) en het veld 
currency (wat altijd EUR bevat) zijn onderdeel van het StatusResponse bericht. De 
Merchant moet controleren dat de waarde gelijk is aan de waarde van amount in het 
TransactionRequest bericht. 


Referentie: Voor meer details: Merchant Integratie Gids v3.3.1 — paragraaf 6.3 StatusResponse 


Het voorkomen van onnodige statusopvragingen 


- Merchants zouden onnodige statusopvragingen moeten vermijden om onnodige belasting van 
het iDEAL systeem te voorkomen. In iDEAL 3.3.1 zijn de definities van excessieve 
statusopvragingen en de beschrijvingen van te vermijden situaties aangescherpt en in meer 
detail beschreven. 


Referentie: Voor details: Merchant Integratie Gids v3.3.1 — paragraaf 6.4 Haalplicht 
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3.8 ErrorResponse (X°) 


- Het createDateTimeStamp veld is toegevoegd aan het ErrorResponse bericht. 








- Het veld suggestedExpirationPeriod wordt niet meer gebruikt. 


- Wanneer de foutmelding optreedt omdat de geselecteerde Issuer niet beschikbaar is, wordt dit 
weergegeven in het consumerMessage, gedeelte, om de Consument de mogelijkheid te 
bieden een andere Issuer te selecteren uit de IssuerLijst. 


- Wanneer een Issuer niet beschikbaar is vanwege gepland onderhoud, maar er is informatie in 
het Notificatiesysteem over wanneer de Issuer opnieuw beschikbaar verwacht zijn, dan wordt 
deze informatie opgenomen in het onderdeel consumerMessage. 


Referentie: Voor details: Merchant Integratie Gids v3.3.1 — paragraaf 7.2 ErrorResponse en 
Appendix C: Foutcodes. 
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